home *** CD-ROM | disk | FTP | other *** search
/ Skunkware 5 / Skunkware 5.iso / tls / tls023e.ltr < prev    next >
Text File  |  1994-11-22  |  7KB  |  171 lines
  1. tls023e contains a version of the soundblaster driver that works with
  2. the Network Audio System in tls066.
  3.  
  4. This version of the soundblaster driver uses /dev/audio instead of /dev/sbdsp.
  5. The ioctl interface to the driver is different.
  6. It is documented in the test directory in README.ioctl and the tests
  7. in that directory show it's use.
  8. This interface is likely to change, but is documented here to play
  9. around with.
  10.  
  11. Shawn McMurdo
  12. (shawnm@sco.com)
  13.  
  14.  
  15. ------------------------------------------------
  16. Previous cover letter:
  17.  
  18. to: Multimedia fans
  19.  
  20. Subj: tls023 - soundblaster driver, etc. original distribution
  21.       tls023d- updated drivers, binaries only
  22.       tls023ds- drivers, source code
  23.  
  24. Here is a version of Brian Smith's Soundblaster(tm) driver.
  25. This goes with tls022, which is some playback and Open Desktop
  26. interface code.
  27.  
  28. The new file here tls023d.tar.Z contains improved/updated drivers
  29. with an install script.   Sources  are in tls023ds.  These might
  30. not precisely match the binaries, but they are close. :-)
  31.  
  32. We are very grateful to Brian Smith and Lance Norskog for their
  33. work in this contribution to the technical community.
  34.  
  35. General comments should be directed to the contributors listed at
  36. the end of the README (below).  Comments specific to the SCO version
  37. would be welcomed by Rick Kamp, rickk@sco.com
  38.  
  39. Dion L. Johnson
  40. SCO Product Manager - Development Systems  400 Encinal St. Santa Cruz, CA 95061
  41. Bangpath:                           ...{ucbvax!ucscc, decwrl, uunet}!sco!dionj
  42. Domain:  dionj@sco.com    FAX: 408-427-5417                  Tel: 408-427-7565
  43.  
  44.  
  45.  
  46.  
  47.                          Sound Blaster(tm) Driver
  48.                        (Copyright 1991, Brian Smith)
  49.  
  50.     Rewritten for Release 3 by Lance Norskog, June 1992
  51.  
  52. This driver has been ported to the SCO environment by various
  53. engineers at SCO.  Problems or suggestions should be sent to 
  54. the mail address at the end of this file.
  55.  
  56. This is a driver and application suite for the Creative Labs'
  57. original monophonic Sound Blaster card.  It should work on
  58. other cards that claim to be SB-compatible, like the SB Pro,
  59. MediaVision, etc.  (The Adlib synth chips are supported, but
  60. you may have to comment out the SB DSP chip support if you
  61. want to run the Adlib or Game Board cards.)
  62.  
  63. Version 1 of the driver & applications was written by Brian Smith 
  64. (brians@rigel.cs.pdx.edu).  Pace Willisson (pace@blitz.com) rewrote
  65. the driver for overall cleanliness and to use in-kernel buffering
  66. to avoid the gottverdammter clicking problem. Independently, I
  67. rewrote the assembler interrupt to attack this issue, and have
  68. since merged my ugly hacks into Pace's very clean rewrite.
  69. As it turns out, you need to get the DSP 2.0 chip from Creative
  70. Labs to solve the clicking problem.
  71.  
  72. The application suite now contains a simple MIDI file player
  73. which uses the mf2t (or mft) MIDI file library.  This library
  74. comes in three forms; mf2t or mft is the latest version from
  75. Piet van Oostrum (piet@cs.ruu.nl).
  76.  
  77. New! MIDI works!
  78.  
  79. Known problems: 1) if you write sound samples in 16k chunks,
  80. the last one will not be played.  2) Loud click at end of
  81. play.  3) There's no protocol for an FM program to share
  82. FM channels with other programs.  4) The init code hangs
  83. in ISC 3.0 and SCO Unix.  No word yet on how to fix this.
  84.  
  85. REQUIREMENTS
  86.  
  87. This driver  and the associated user programs require a 386/486 system
  88. running System V 3.2 Unix.  It has been tested on Open Desktop 2.0 and
  89. UNIX 3.2v4 systems.  Remember, though, THERE IS NO WARRANTY.
  90.  
  91. As a  character driver, it should port easily to Linux and the various
  92. BSD 386 ports going on.  There is a Streams driver that presently only
  93. does  MIDI; this should port to V.4 easily.  It should also be easy to
  94. port  the  sampling and  FM  synthesis  parts  of  the driver into the
  95. Streams version, but nobody's done it yet.
  96.  
  97. (There is a separate driver for the SB-Pro on 386 BSD:
  98. contact Steve Haenischen, haenisch@ucsd.edu.)
  99.  
  100. GENERAL INFORMATION
  101.  
  102. This driver  is for the  Sound Blaster sound card designed by Creative
  103. Labs,  Incorporated.   The  Sound  Blaster  is  a  sound card  for the
  104. IBM-PC(tm) type I/O bus.  The card is capable of sampling sound from a
  105. microphone jack from 4KHz  to  23KHz (or 24KHz,  depending  upon which
  106. portion of the manual you believe) at 8 raw bits of resolution.  It is
  107. also capable of playing  samples at speeds from 4KHz up to 12KHz.  The
  108. board  can play raw 8 bit samples, or  2 bit,  2.6 bit, or 4 bit ADPCM
  109. packed samples.  ADCPM  is a lossy  method  of data  compression.  The
  110. sampling and output may  be directly driven by the  CPU, or it  may be
  111. driven by DMA.  The card  is also capable of  playing music through an
  112. on-board  FM synthesizer  chip.   The  chip  may  play 9  simultaneous
  113. instruments, or  it  can play 6 simultaneous voices  with 5 additional
  114. rhythm instruments.  In  addition, the  board (but NOT my driver) also
  115. supports the addition of 2 C/MS chips. For  more information, read the
  116. advertising blurb, errr...  manual which comes with the Sound Blaster.
  117.  
  118. The driver is  capable  of utilizing only a subset of the capabilities
  119. of the Sound Blaster card.  The driver is accessed through four device
  120. nodes.
  121.  
  122. The /dev/sbdsp node accesses the DSP  chip which controls sampling and
  123. sample playback.  Only 8-bit sound is supported thus far.  The  driver
  124. utilizes  DMA,  and  therefore is very unobtrusive to the system load.
  125. The ls  utility is  harder upon the system.  Read(2) and write(2) upon
  126. /dev/sbdsp sample  sound and  play back  sound  samples, respectively.
  127. Several  ioctl(2)'s  control sampling/playback speed,  resets,  etc...
  128. The play_snd utility demonstrates the use of the /dev/sbdsp node.
  129.  
  130. The /dev/sbfm node accesses the  FM chips.  The only access to  the FM
  131. chips are through  ioctl(2)'s.  The play_cmf utility demonstrates  the
  132. use  of the FM chips  by (mostly) interpreting  and playing CMF files.
  133. The various options  controlling the voices  can be dumped  from a CMF
  134. file by the get_instruments utility.  Those familiar with synthesizers
  135. can then learn how to create their own instruments.
  136.  
  137. The /dev/sbcms node accesses absolutely nothing.  The  C/MS chips  are
  138. really awful, and Creative Labs is trying to forget it ever used them.
  139.  
  140. The  /dev/sbmidi node  does MIDI I/O  if you have  a  MIDI  dongle box
  141. attached to the joystick port.   The  driver reads & writes a longword
  142. per MIDI byte, with the other 3 bytes giving a Unix time code.
  143.  
  144. This driver is merely the rough outlines of what it could be.  Support
  145. could be added for oodles of  features, like  efficiency improvements,
  146. and ADCPM interpretion for the /dev/sbdsp node.  If you wish to add to
  147. this driver, please be my guest (after reading the license file).
  148.  
  149. The file sb.prog.doc gives the complete info on programming the SB and
  150. SB Pro.  If you have an SB  Pro and want to  hear it do stereo, you'll
  151. have to modify this software.  Please send in your changes.
  152.  
  153. With Brian's  consent,  I have taken over as maintainer of this suite.
  154. Please!  Send  your fixes to  me,  and I'll integrate them, test them,
  155. and send the  patches to Usenet.  That way, there won't be billions of
  156. versions of this driver to contend with.
  157.  
  158. Send money to Brian Smith, if you want.  
  159.  
  160. The current list of contributors is:
  161.  
  162.     Brian Smith        (brians@rigel.cs.pdx.edu)
  163.     Lance C. Norskog    (thinman@netcom.com)
  164.     Pace Willisson        (pace@blitz.com)
  165.     Rick Richardson        (rick@digibd.com)
  166.     Rick Kamp        (rickk@sco.com)
  167.  
  168. Enjoy!
  169.  
  170. Lance C. Norskog
  171.